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Customer Satisfaction 


Limitation on Warranties 
and Liability 


Copyright 


Product Revisions 


If you discover physical defects in the manuals distributed with an Apple product or in the 
media on which a software product is distributed, Apple will replace the documentation 
or media at no charge to you during the 90-day period after you purchased the product. 


In addition, if Apple releases a corrective update to a software product during the 90-day 
period after you purchased the software, Apple will replace the applicable disks and 
documentation with the revised version at no charge to you during the six months after 
the date of purchase. 


In some countries the replacement period may be different; check with your authorized 
Apple dealer. Return any item to be replaced with proof of purchase to Apple or an 
authorized Apple dealer. 


Even though Apple has tested the software described in the manual and reviewed its 
contents, neither Apple nor its software suppliers make any warranty or representation, 
either express or implied, with respect to this manual or to the software described in this 
manual, their quality, performance, merchantability, or fitness for any particular purpose. 
As a result, this software and manual are sold ‘‘as is,’’ and you the purchaser are 
assuming the entire risk as to their quality and performance. In no event will Apple or its 
software suppliers be liable for direct, indirect, incidental, or consequential damages 
resulting from any defect in the software or manual, even if they have been advised of the 
possibility of such damages. In particular, they shall have no liability for any programs or 
data stored in or used with Apple products, including the costs of recovering or 
reproducing these programs or data. Some states do not allow the exclusion or limitation 
of implied warranties or liability for incidental or consequential damages, so the above 
limitation or exclusion may not apply to you. 


This manual and the software (computer programs) described in it are copyrighted by 
Apple or by Apple’s software suppliers, with all rights reserved. Under the copyright laws, 
this manual or the programs may not be copied, in whole or part, without the written 
consent of Apple, except in the normal use of the software or to make a backup copy. 
This exception does not allow copies to be made for others, whether or not sold, but all of 
the material purchased (with all backup copies) may be sold, given, or lent to another 
person. Under the law, copying includes translating into another language. 


You may use the software on any computer owned by you, but extra copies cannot be 
made for this purpose. For some products, a multi-use license may be purchased to allow 
the software to be used on more than one computer owned by the purchaser, including a 
shared-disk system. (Contact your authorized Apple dealer for information on multi-use 
licenses.) 


Apple cannot guarantee that you will receive notice of a revision to the software 
described in the manual, even if you have returned a registration card received with the 
product. You should periodically check with your authorized Apple dealer. 


© Apple Computer, Inc. 1984 
20525 Mariani Avenue 
Cupertino, California 95014 


Apple and the Apple logo are registered trademarks of Apple Computer, Inc. 
Simultaneously published in the United States and Canada. All rights reserved. 


CP/M is a registered trademark of Digital Research, Inc. 
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System is short for computer 
system, which refers to your 
computer and all its peripheral 
devices. 


A file is a collection of information 
stored on a disk. If you're 
unfamiliar with this term or others 
in this book, refer to the interactive 
Owner's guide. 


Jo1deuyo0 
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This book explains how to use the System Utilities disk that 
came with your Apple Ilc. You should read Apple Presents the 
Apple lic: An Interactive Owner’s Guide before you read this 
book. 


Utilities is a word you probably associate with water, gas, and 
electric services. Well, just as home utilities keep your home 
operating efficiently, system utilities keep your computer 
operating efficiently. 


System Utilities is a set of programs that gives you control over 
the information you save on disks. (Which is pretty vital, when 
you consider all the vital information people entrust to disks: 
term papers, tax records, novels, financial models, programs.) 


One of the most important things the utilities disk does for you 
is prepare, or format, your data disks. When you format a 
disk, the utility divides the magnetic surface of the disk into 
sections where information can be stored in files. Formatting is 
an important utility because you can’t save anything on a disk 
until it has been prepared. Other utilities let you copy disks and 
individual files, check which files are on a disk, and erase files 
from disks so you can reuse the disk space. 


Mastering these utilities is a giant step toward computer 
confidence. You won't have to worry about losing valuable 
information because you'll have backup copies of all your 
important disks. And you won't have to keep a handwritten 
record of what's on a disk because you'll know how to check 
its contents. 


While the utilities disk is an invaluable part of your software 
library, it is not a substitute for application programs. You can't 
use it to write letters or prepare budgets. But you must use it to 
format disks that receive your letters and budgets, and once 
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you have those letters safely stowed in files on disks, you can 
use the utilities disk to copy them, delete them, rename them, 
and otherwise organize them. 


Some Applications Include Utilities: Some application 
programs have formatting and other utilities built in. When 
this is the case, go ahead and use the utilities on your 
application disk. 


Configure the Serial Ports: Another important part of the 
utilities disk lets you adapt the ports on the back of the 
Apple llc for printers, plotters, or modems that don’t work 
automatically with the Apple llc. Configure the Serial Ports, 
an option on the Advanced Operations Menu, is explained in 
Chapter 4. 


Experienced Users: [he utilities disk works on Pascal, 
DOS 3.3, and ProDOS disks. It incorporates utilities and 
conversion functions from the DOS 3.3 System Master disk 
and most of the Pascal Filer and ProDOS utility functions. 


ie Using the Utilities Disk 


The best way to learn how to use System Utilities is by 
experience. In the next few pages, you'll get a step by step, 
guided tour through one of the most valuable utilities— 
Duplicate a Disk. This utility allows you to copy important disks 
in your software library so you'll have a backup in case 
something happens to the original. 


All the utilities work pretty much the same way, SO once you 
master Duplicate a Disk, you'll have no trouble using the others. 


& Hands-On Introduction to Utilities 


For more on flexible disks, 
review the interactive owner’s 
guide. 


4 


Don't just read about duplicating a disk, do it! Follow these 
instructions and make a backup copy of System Utilities. 


Before you can make a copy of the utilities disk, you need a 
blank disk. If you don't have any blank disks, go out and get a 
box at your local computer store. The Apple llc uses 5%-inch, 
single-sided, single-density flexible (floppy) disks. 
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Starting Up 
First start up System Utilities. 


1. Put the disk labeled System 
Utilities in the built-in disk 
drive. 


2. Turn on your monitor. 
3. Turn on your computer. 


In a moment, you see the System Utilities Main Menu 
(Figure 1-1). 


Figure 1-1. System Utilities Main Menu 


Menu Name 


Highlighted Option 


Numbered Option 


Your Instructions 





How to Get Help 
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Using 80 Columns? If you are using an 80-column display, 
your screen will look slightly different. 


Duplicate a Disk 


You're going to be duplicating a disk, which is the fifth option 
on the Main Menu, so you want to highlight that option. 


1. Press (4) four times. Duplicate a Disk is 
You can also choose from a menu highlighted (the option is 
by typing the option’s number and 
pressing (RETURN). In this case, you changed to uppercase and 
would press (5) and then (RETURN). enclosed in angled brackets). 
2. Press This accepts the highlighted 
option. 


Your screen looks like Figure 1-2. 
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Figure 1-2. Source Disk Display 


Duplicate a Disk 
ESC: Main Menu 


Where i5 your Source disk? 


1. <BUILT-IN DRIVE> 


fa External Drive 


Type a number or press | or t to select 
an option. Thén press RETURN. _ : 


For Help: Press G-? or «-? 


The Source Disk display invites you to supply information about 


The source disk is the original— _—s the location of the disk you want to copy from (the source 
the disk you're copying from. disk). 


You want to make a copy of the System Utilities disk, which is 
in the built-in disk drive. 


3. Press The option you want is 
highlighted, so you just have 
to accept it. 


Now you're asked to supply information about the location of 
The destination disk is the new — the disk you want to copy to (the destination disk). 
disk—the disk you're copying to. 
How you answer this question, and how you proceed, depends 
on whether or not you have an external disk drive. If you have 
an external disk drive, read the next section. If you don't have 
an external disk drive, skip the next section and read the 
section “Built-in Disk Drive Only.” 
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A default is what the program 
thinks you will want. 


Volume is another word for disk. 


Built-in Disk Drive and External Disk Drive 


Since you have two disk drives, you can use the built-in disk 
drive for your source disk and the external disk drive for your 
destination disk. 


1. Press (1) once. External Drive is 
highlighted. 

2. Press This accepts the highlighted 
option. 


You see a message telling you where to put your source and 
destination disks. 


Your source disk, System Utilities, is already in the built-in disk 
drive so all you have to do is put your destination disk in the 
external disk drive and tell the computer you're ready to start 


copying. 


3. Put a blank disk in the 
external disk drive. 


4. Press 


You see a message telling you the source disk’s operating 
system, and then you see a message requesting a name for 
your copy and a default answer: 


Enter Name of New Volume: /UTILITIES 


UTILITIES is the name of the System Utilities disk. That 
name will be fine for the destination disk, so accept it. 


5. Press UTILITIES is used to name 
your destination disk. 


A short while after that, you see this message: 
Formatting... (Disks have to be formatted before 
information can be recorded on them for the first time.) Then 
you see: Done! 


After that, you see this message: Duplicating... Then 
you see: Done! That’s all there is to it. 
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A default is what the program 
thinks you will want. 


Volume is another word for disk. 


Skip the next section for single disk drive users and proceed to 
the section “Finishing Up.” 


Built-in Disk Drive Only 


You're going to alternate between putting your source disk and 
your destination disk in the built-in drive until the duplication is 
complete. But first you need to supply information about the 
location of your destination disk. 


1. Press This indicates that you'll be 
putting your destination disk in 
the built-in disk drive. 


First you see a message telling you to put the source disk in 
the built-in drive. Your source disk is System Utilities, which is 
already in the built-in disk drive. 


2. Press 


Then you see a message telling you to put your destination disk 
in the built-in disk drive. 


3. Replace System Utilities Pressing lets the 
with a blank disk and press computer know you are ready 
to continue. 


You see a message telling you the source disk’s operating 
system, and then you see a message requesting a name for 
your copy and a default answer: 


Enter Name of New Volume: /UTILITIES 


UTILITIES is the name of the System Utilities disk. That 
name will be fine for the destination disk, so accept it. 


4.Press UTILITIES is used to name 
your destination disk. 


After a few seconds, you see this message: Formatting... 
(Disks have to be formatted before information can be recorded 
on them for the first time.) Then you see: Done! 
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After that, watch for messages on the screen telling you when 
to swap System Utilities (the source disk) for your blank disk 
(the destination disk). Be patient—the copy procedure involves 
quite a few swaps. When it’s all over, you see this message: 
Disk Copy Complete. 


Finishing Up 


Take your new backup copy of System Utilities out of the disk 
drive and label it using a felt-tip pen (using a ball-point pen or a 
pencil can damage the disk). 


Put the original System Utilities disk in a safe place and use 
your backup copy from now on. 


Copying Disks: You can use Duplicate a Disk to copy all 
the disks that come with the interactive guide, but don’t be 
surprised if you can’t duplicate every application program you 
buy. Many manufacturers copy protect their disks to protect 
themselves from software pirates who illegally duplicate and 
distribute their programs. 


Return to the Main Menu by pressing (ESC). 


WS Now What? a 


Now that you’ve had some hands-on experience with Duplicate 
a Disk, you’re probably eager to see what else System Utilities 
can do. 


e Chapter 2 summarizes the utilities available on the disk. 
e Chapter 3 offers some general instructions for using the disk. 


e Chapter 4 explains how to adapt the ports on the back of the 
Apple llc for printers, plotters, or modems that don’t work 
automatically with the Apple Ilc. 
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For those who like the big picture, here’s a roadmap of System 
Utilities. 


Figure 1-3. Utilities Roadmap 


System Utilities Main Menu 


1 2 3 4 5 6 Th 8 9 
Copy Delete Rename Lock/Unlock Duplicate Format Identify Advanced Exit 
Files Files Files Files a Disk a Disk and Catalog Operations System 
a Disk Utilities 


Advanced Operations Menu 





1 
Set the 


2 3 4 5 
Create a Change a Verify That Configure 
Prefix 


Subdirectory | |Disk’s Format a Disk Is the Serial 
Readable Ports 





Configure the Serial Ports Menu 
1 


Set 
Port 1 


Set 
Port 2 


3 
Edit the 


Device 
List 





Now What? 144. 


























~ 











fc 10a31deyY9 


This chapter summarizes the utilities on the System Utilities 
disk. 


- Copy Files 


Copy Files lets you copy a file or files from one disk to another. 
It comes in handy when you want to share a financial model or 
a program you've written with a friend or business associate. (If 
you want to copy all the files on a disk, you're better off using 
the Duplicate a Disk utility.) 


i Delete Files 


Delete Files lets you permanently erase files that have outlived 
their usefulness so you can reuse the disk space. It’s the disk 
equivalent of spring cleaning. (If you want to delete everything 
on a disk, it's quicker to use the Format a Disk utility.) 


ae Rename Files 


Rename Files lets you rename a file without changing its 
contents. It comes in handy for the author who decides that 
Chapter 1 should be Chapter 3, and for anyone else who has 
ever changed his mind. 
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© Lock/Unlock Files a 


Lock/Unlock Files lets you lock files so you don’t delete them, 
rename them, or change their contents by mistake. If you’re 
sure you want to delete or alter a locked file, you can also use 
this utility to unlock it. 


“ Duplicate a Disk a 


As you discovered in Chapter 1, Duplicate a Disk lets you make 
an exact copy of a disk. If you believe in insurance for your 
home and car, you'll want to take out some disk insurance with 
this invaluable utility. 


Don’t Take Chances: When you're making copies of 
important disks, it’s a good idea to cover the notch on your 
source disk with one of the sticky write-protect tabs that 
If any of the disk-related terms, come with blank disks—just in case you get your source and 
such as write-enable notch and destination disks confused during the copy process. (Some 
write-protect tab, are new to : ; - ) 
you, see the interactive owner’s disks dont have write-enable notches. You couldn't 
guide. change the contents of the disk even if you wanted to, so 
with these disks you don’t have to worry about using a 


write-protect tab.) 


a Format a Disk - 


Formatting a disk means dividing the magnetic surface of the 
disk into sections where information can be stored. You can’t 
Store information on a blank disk until it has been formatted. 


So why don't blank disks come preformatted? Disks don’t come 


An operating system is a preformatted because different operating systems store 
program that controls things: for information on disks in different ways. Your word processing 
instance, the way information is d isk i be f df h : 

loaded into memory, the way the ata dis as to e€ tormatted for the operating system your 
computer works with information, word processing program uses. If your home finance program 


and the way information is stored has a Pascal operating system and your word processing 


on a disk. There are three h ProDOS ,; "I 
operating systems available for the | Program has a Pro operating system, you ll need two 


Apple llc: ProDOS, Pascal, and different data disks. 
DOS 3.3. 
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DOS 3.2 is an early Apple II 
operating system. 


The destination disk is the disk 
you copy to. 


If you know which operating system your program requires (it’s 
often printed on the label or mentioned in the manual), you can 
save time by supplying that information when the formatting 
utility asks for it. If you don't have a clue, the utilities disk can 
figure out the operating system and format the disk accordingly. 


Early DOS: The Apple Ilc doesn’t recognize DOS 3.2 files 
and disks (except to catalog them), but you can use the 
Change a Disk’s Format utility (one of the options on the 
Advanced Operations Menu) to convert a DOS 3.2 disk to 
DOS 3.3 format. 


Although you must format blank disks before you can use them, 
disks don’t have to be blank to be formatted. It is important, 
however, that the information on the used disk is expendable. 
When you format a disk, everything that was stored on the disk 
is erased. 


The only time you don’t have to format blank disks before you 
use them is when you use the Duplicate a Disk utility. Duplicate 
a Disk formats the destination disk before copying 
information onto it. 


BASIC Programmers: If you want to create a ProDOS 
startup disk, see the appendix. | 


ca Identify and Catalog a Disk 


One block equals 512 bytes, and 
it takes one byte to store one 
character. 


Identify and Catalog a Disk displays a list of what's on a disk. 
It's a valuable tool because you can't open a disk, aS you cana 
book, to see what's inside, and it’s a nuisance to keep a written 
record of every file you save on a disk. 


In addition to telling you which files are on a disk, Identify and 
Catalog a Disk tells you the disk’s operating system, the disk’s 
name (or number in the case of DOS 3.2 or DOS 3.3 disks), 
each file's type, each file’s size (measured in blocks), the 
number of files on the disk, the number of blocks taken up by 
the files, and how many blocks are available on the disk. 


Identify and Catalog a Disk 15. 





# Advanced Operations _ 


In addition to the utilities listed on the Main Menu, there are five 
advanced utilities: Configure the Serial Ports, Verify That a Disk 
Is Readable, Change a Disk’s Format, Create a Subdirectory, 
and Set the Prefix. (Create a Subdirectory and Set the Prefix 
only apply to ProDOS disks.) 


To get to the Advanced Operations Menu, select Advanced 
Operations from the System Utilities Main Menu. 


Set the Prefix (ProDOS Only) 


A prefix is the first part of a Set the Prefix lets you store the first part of a pathname (the 
pathname. A pathname is the full = yolume name and any subdirectory names) in the memory of 
name of a file. It begins with the 

name of the disk (or volume), then the computer so you can access files in that directory or 

lists any subdirectories (if you use subdirectory simply by typing the rest of the pathname (usually 
subdirectories), and ends with the = just the filename). Once you set the prefix, it stays set until 
filename. Each name in the : 

pathname is separated with a you change it or turn off the computer. 

slash. For example: 

/USA/UTAH/SALT.LAKE —————— SSS 


Create a Subdirectory (ProDOS Only) 


When a disk is first formatted, two things happen: the disk’s 
recording surface is divided into sections where information can 
be stored and the disk gets a directory (or catalog). Every file 
you save on the disk is listed in that directory. 


If your disk is ProDOS formatted, you can set up subdirectories 
within the disk directory and group related files together. Before 
you can put files into a subdirectory, you must create it, using 
this utility. 


Subdirectories are like drawers in a file cabinet. Imagine a disk 
named MONEY with two subdirectories—one called INCOME, 
the other called EXPENSES. To access a file called 
FREELANCE in the INCOME subdirectory on this disk, you'd 
supply the file's pathname: the name of the disk, then the name 
of the subdirectory, and, finally, the name of the file (each name 
separated with a slash). Here’s how it would look: 


/MONEY/INCOME/FREELANCE 


Subdirectories Aren’t for Everyone: /f at first you find 
the idea of subdirectories confusing, don’t use them. 
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If you organize your files into subdirectories, you must supply 
the ProDOS pathname to get to your files—instead of the 
location of the disk (built-in or external disk drive). 


If you’re going to be using files in the same subdirectory for a 
while, you can save typing time by setting a prefix (see “Set the 
Prefix’). 


Verify That a Disk Is Readable 


Verify That a Disk Is Readable checks to see if a disk is OK. 
Disks are sturdy enough to withstand hundreds of trips in and 
out of the disk drive, but they become temperamental if you 
leave them on the dashboard all afternoon in the hot sun or 
otherwise abuse them. Occasionally, disks are damaged during 
manufacture. 


Use Verify That a Disk Is Readable to check newly formatted 
disks before entrusting valuable data to them. You can also use 
this utility to check disks you suspect have been damaged. If 
you discover that a disk is bad, use Copy Files to salvage any 
files you can to another disk. Then reformat the disk and check 
it again using this utility. If it’s still bad, throw it away. 


Change a Disk’s Format 


Change a Disk’s Format lets you convert disks from DOS 3.2 to 
DOS 3.3, DOS 3.3 to ProDOS, and ProDOS to DOS 3.3. 


Warning 

Converting programs from DOS 3.2 to DOS 3.3 is no problem, 
but when you convert programs of other operating systems, 
you usually have to make substantial changes to the program 
before it will run under the new operating system. 


Configure the Serial Ports 


Configure the Serial Ports lets you set up the printer and 
modem ports on your Apple lic to communicate with devices 
that don't work automatically with the Apple IIc. This utility is 
explained in detail in Chapter 4. 
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As you discovered when you used System Utilities to make a 
backup copy, using the utilities is fairly straightforward. 
Messages on the screen tell you what your options are and ask 


Prompts are messages on the you for information the program needs. Rely on these prompts 
eal and you should have no trouble using any of the utilities on this 
disk. 


se Getting Help 


Press(G)-(@) or(#)-(@) for helpful If you hit a snag, press (<G)-(7) and you'll get a screen full of 

mints. on-line coaching. If the help screens don’t answer your 
questions, review the general instructions in this chapter and in 
Chapter 2. 


el Selecting From a Menu 


There are two ways to select items from a System Utilities 
menu: 


@ Type the number of your selection and press (RETURN ). 


e Press or to highlight your selection and then press 
(RETURN ). 
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WW selecting the Disk Drive _ 


The source disk is the disk 
you're copying from. 


The destination disk is the disk 
you're copying to. 


A pathname is the full name of a 
file. It begins with the name of the 
disk (or volume), then lists any 
subdirectories (if you use 
subdirectories), and ends with the 
filename. Each name in the 
pathname is separated with a 
slash. 


Once you pick the utility you want to use, you're usually asked 
to select the location of the disk you'll be working on. If you're 
going to put the disk in the built-in disk drive, select option 1, 
Built-in Disk Drive. If you're going to put the disk in the external 
disk drive, select option 2, External Disk Drive. It’s as simple as 
that. 


With some utilities, like Duplicate a Disk and Copy Files, you 

are asked for the location of two disks: the disk you're copying 

from (the source disk) and the disk you're copying to (the 
destination disk). If you have an external disk drive, you can 
put your source disk in one drive and your destination disk in 
the other. If you don't, select the built-in disk drive as the 
location for both the source and destination disks and watch for 
messages on the screen telling you when to swap the source 
disk for the destination disk. 


Selecting by Pathname: If the disk you’re working on Is 
ProDOS-based, you may have the option of identifying files by 
pathname (the third option) instead of by disk drive. If you 
use subdirectories, you must use this option. 
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What happens after you select a utility and disk drives depends 
on whether you're working on the disk as a whole or on 
individual files. If you're working on the disk as a whole, your 
job is practically finished. Watch the screen for any remaining 
instructions. If you're working on files, you are asked whether 
you want to select some of the files on the disk or all of the 
files. 


If you want to copy, delete, or lock all the files on the disk, 
press (A), for A//, and then (RETURN). Then watch for messages 
on the screen telling you what to do. 


lf you want to select only some of the files on the disk for 


copying, renaming, or whatever, press to accept the 
default. The next screen you see is a list of all the files on the 
disk. 
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Press (4) or (4) to highlight a file you want to work on. Press (+) 
to mark the file. A check will appear next to the file. (If you 
change your mind, you can unmark the file by moving the 


highlight to it and pressing 


If there is more than one row of files on the screen, press 
to move back and forth between rows. 








Figure 3-1. Marking Files 


Marked File 


Highlighted File 





When you've marked all the files, press (RETURN). Then watch 
for screen messages telling you what your Apple llc is doing 


and what you should do. 
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ie Naming Disks and Files - 


Some utilities will ask you to give your disk or file a name. You 
can be as creative as you want, within these guidelines: 


e Names must begin with a letter. 


e Names must be made up of only letters, numbers, and 
periods. 


e Names cannot have any spaces or punctuation other than 
periods. 


e Names cannot have more than 15 characters (except Pascal 
Volume is another word for disk. volume names, which can have only seven characters). 


Naming DOS 3.3 Files: Rules for naming DOS 3.3 files are 
different from the ones just outlined, but if you follow these 
general rules, you won't have to worry about which operating 
system you re working with. 


Defaults 


When the program asks you to name a disk or a file, it usually 
It's called a default because it will provides a default name for you. You can accept the default 
be used by detault if you don't by pressing (RETURN), you can override the default by typing in a 
provide an alternative. ; 

new name, or you can edit the default. 


To enter an entirely new name, just start typing the name. (The 
default disappears.) Press when you're finished typing 
the name. To edit the default, press and to move the 
cursor to the spot where you want to insert characters and type 
them in. Press to erase characters to the left of cursor. 
Press when you are finished editing the name. 


Lal Making Your Escape - 


Wherever you are in System Utilities, you can press to 
return to the previous menu. 





Pressing while you are in the middle of a file utility lets 
you stop what you are doing at the first opportunity. This 
comes in handy if you change your mind after you start using a 
utility. 
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ee Quitting 


When you are finished using System Utilities, select the last 
option on the Main Menu: Exit System Utilities. You are asked if 
you are sure you want to leave System Utilities. lf you are sure, 
answer Yes by pressing (RETURN), and you'll exit to Applesoft 
BASIC. 


If you left System Utilities by mistake, answer No, and you'll 
find yourself back at the Main Menu. 


If you want to start up an application program, put the program 
disk in the built-in drive and hold down and while 
you press (RESET). 
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Serial devices send and receive 
information one bit at a time while 
parallel devices send and receive 
information eight bits (one byte) at 
a time. 


Printing a copy of a catalog is one 
of your options when you use the 
Identify and Catalog a Disk utility. 


p3suaideyosd 


Most of the utilities on System Utilities are related to files or 
disks. The exception is Configure the Serial Ports, one of the 
options on the Advanced Operations Menu. 


Configure the Serial Ports lets you adapt the printer or modem 
ports on your Apple Ilc to communicate with devices that don't 
work automatically with your computer. 


Important! You will need to use this utility only if your 
, ee device doesn't work < automatically | with the — 


Apple llc. 


When you turn on the power, the Apple llc serial ports are 
automatically set up, or configured, to communicate with an 
Apple Imagewriter printer in the printer port (port 1) and an 
Apple 300 Baud Modem in the modem port (port 2). If you have 
these devices, or a device that uses the same configuration 
(speaks the same language), just plug in your printer or modem, 
and you're ready to go. 


The easiest way to find out if your printer will work 
automatically with the Apple IIc is to plug it into the printer port 
and try printing a catalog of System Utilities. |f it works, your 
device has a standard configuration. If you get a page full of 
garbage, you need to change the switch settings as described in your 
printer manual or configure the port. 


Try Your Application Programs: Some application 
programs will override the configuration, so try printing 
something after starting up your application program. lf it 
works, you don’t need to configure your printer port. 
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To find out if your modem will work with the Apple IIc, plug it 
into the modem port and try sending or receiving a message. If 
it works, you don't need to configure your modem port. If it 
doesn't, you'll need to configure one of the ports for your 
modem. 


The nice thing about the serial ports is that you’re not limited to 
Apple and similarly configured devices. The serial ports can be 
configured to accommodate a wide variety of peripheral 
devices. Configuring a port tells the port how to communicate 
with a particular peripheral device. 


Using the Utility - 


You don't have to be a programmer to configure a serial port 
on the Apple lic. All you have to do is answer a set of multiple 
choice questions about your peripheral device, and the 
configuration utility will tell the port how to communicate with 
your device. 


You should be able to find the answers to all of the multiple 
choice questions in the manual that came with your device. If 
you can't find the answer, accept the default. (The default 
answers are the most common settings.) If that doesn’t work, 
you'll find a set of troubleshooting tips later in this chapter, and 
you can use trial and error to find the right configuration for 
your device. 


Once you answer the multiple choice questions about your 
device, the configuration utility 


A product identification e Displays a product identification number (PIN) for your 
number (PIN) describes a device 
device's characteristics and is used 


eae the serial ports of the = ~Configures port 1 or port 2 for your device 


e Gives you the chance to save your device’s PIN on your 
utilities disk as the new default configuration for port 1 or 
port 2. 
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More Than Two Serial Devices: If you have several 
devices that will share ports 1 and 2, or if you have different 
configurations for the same device—maybe you use the 
same modem to communicate with two information services 
with different configuration requirements—the configuration 
utility lets you list all of your devices and their PINs. That 
way, when you swap devices, all you have to do is select the 
device from the list and let the utility set up the port for you. 
(You'll learn how in “Editing the Device List.”) If you have one 
or two devices, you don't need to list them, you can just 
make their PINs the defaults for ports 1 and 2. 


ef Saving PINs for Next Time 


Once you've figured out a device’s PIN, you never have to do it 

again. That PIN can be saved on your utilities disk. But when 

you turn off the computer's power, your new serial port 

configuration is erased from the computer's memory (because 
Random-access memory is PINs are stored in random-access memory). So, you need 
explained in the interactive owner's — tg configure the serial ports for your devices every time you 
ee turn on the power. Fortunately, it's very simple. 


All you have to do is start up your copy of the utilities disk. 
Once you see the Main Menu, your customized serial port 
configuration is set. Then replace your utilities disk with the 
application program's disk and restart the computer by holding 
down while you press (CONTROL )-( RESET ). 


Some Application Programs Configure Ports for 
You: Some application programs, designed for the Apple llc, 
will ask for PINs and configure the serial ports for you so 
you won't have to start up your utilities disk before starting 
up the application. If you don’t know the PIN for your device, 
use the configuration utility or Figure 4-1 to derive it. 
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Switching Application Programs: |f you leave the 
computer’s power on, you should be able to switch from one 
application program to another without reconfiguring the 
serial ports. However, some programs may inadvertently 
interfere with the PIN settings (by using the same part of 
memory). If you lose touch with your peripheral devices, start 
up your utilities disk (to reconfigure the ports), then start up 
your application program by pressing (6G )-(CONTROL )-(RESET ). 


So much for background. The first step in configuring a serial 
port is determining your device's product identification number. 


a The Parts of the PIN - 


Here’s what goes into determining your device's PIN (product 
identification number). You might want to look up the 
information for your device (and write it down on the form at 
the end of this section) before using the configuration utility. 
| That way, when the utility asks for your device’s baud rate, data 
Some printer and modem manuals = format, and so on, you'll have the answers at your fingertips. If 
provide the PIN for the device, ; 
you already know the PIN for your device, you can skip this 


allowing you to bypass the multiple . 
choice questions. section and go on to “Setting the Serial Ports.” 


Mode 


Mode is a general purpose computer term. In this case, it 
refers to the method of communicating with a peripheral device. 
If you're configuring the port for a printer or plotter, choose 
printer mode. If you're configuring the port for a modem, 
choose communications mode. 


1% Printer Mode 
2. Communications Mode 


28 | Chapter 4: Configure the Serial Ports 


Data Bits and Stop Bits 


The computer sends and receives each character of information 
(or data) as a string of bits (zeros and ones). Characters can be 


represented with six, seven, or eight data bits. Stop bits 
indicate the end of a character. You can have one stop bit or 


two. You have six options: 


1. & Data Bits ¢ 1 Stop Bit 
e. 6 Data Bits / @ Stop Bits 
3. 7 Data Bits / 1 Stop Bit 
4. 7 Data Bits / 2 Stop Bits 
5. 8 Data Bits / 1 Stop Bit 
6. 8 Data Bits / 2 Stop Bits 


If you can't find this information in your manual (data bits and 
stop bits are usually listed under “data format” or on a 
specifications page), the most common data format for printers 
is eight data bits and two stop bits. 


Choosing the data format for a modem depends on the 
information service you’re using. Consult the manual provided 
by the information service to find out what data format to use. If 
you cant find any specifications for data format, use the most 
common format for modems: eight data bits and one stop bit. (If 
that doesn't work, try seven data bits and two stop bits.) 


Baud Rate 


Computers send and receive information at a certain speed 
measured in bits per second, also known as the baud rate. 
You have seven options: 


110 Bits per Second 

300 Bits per Second 

1200 Bits per Second 
2400 Bits per Second 
4800 Bits per Second 
9600 Bits per Second 
19200 Bits per Second 


You'll usually find this information on a specifications page in 
the manual that came with your printer or modem. The most 
common printer speed is 9600 baud. The most common modem 
baud rate is 300. The important thing is that your printer and 
computer, or your modem and the information service, are 
using the same baud rate. 


NOOB WD = 
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Parity 


Some devices use a parity bit for error checking—to make sure 
data doesn't get garbled during transmission. You have five 
options: 


No Parity 
Even Parity 
Odd Parity 
Mark Parity 
space Parity 


mn AWD = 


When in doubt, choose option 1. 


Video Echo 


How you set video echo for a modem depends on whether 
youre communicating with a full duplex or a half duplex 
modem. (Most information services use full duplex.) A full 
duplex modem will echo every character you transmit back to 
your video monitor. So you should choose option 1. (If you 
choose option 2, you'll get two of every character on your 
screen.) 


A half duplex modem won't echo the characters you transmit, 
so if you want to see what you’re sending out, you must echo 
the output, option 2. 


It's best to set option 1 for printers because echoing output to 
the screen can limit the line width of what you’re printing to the 
line width of the screen. 


1. Do Not Echo Output on Screen 
C. Echo Output on Screen 


When in doubt, choose option 1. 
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Line Feed 


some printers and some application programs automatically 
generate a line feed (go to the next line) after each carriage 
return; others don't. 


When in doubt, generate a line feed, option 2, and try printing 
something. If it looks right, you're in business. If everything is 
double-spaced, make sure the automatic line feed switch on 
your printer is off. If you still get double-spacing, the extra line 
feed is coming from your application program and you should 
change to option 1. 


LF stands for line feed. CR 1. Do Not Insert LF After CR 
stands for carriage return. 2% Insert LF After CR 
Line Width 


Line width indicates the number of characters that your printer 
will print per line (before generating a carriage return). Set it to 
the greatest width your printer can handle. The most common 
setting is 80 characters. Many application programs let you set 
the width from within the program. If that’s the case, or if you 
find the computer adding carriage returns where they don’t 
belong, choose option 1 and the computer won't try to control 
line width. 


Always choose option 1 for plotters. 


Do Not Insert CR 

Insert CR After 40 Characters 

Insert CR After 72 Characters 

Insert CR After 80 Characters 

Insert CR After 132 Characters 


mAWD => 


important! If you selected Communications Mode, the utility 
picks option 1 for you. 
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W write It Down - 


Here’s a Summary of the defaults for each port. You might want 
to fill in your own settings for reference and comparison. 
Remember, if you can't find one of the settings in the manual 
Supplied with your device or information service, go with the 
default. 


Port 1 Default Your Device 


Printer Mode ne ae PTS CNR E NE etree ee 
8 Data Bits / 2 Stop Bits ee ee eee ee 
9600 Bits per Second ee ee 
No Parity ee 


Do Not Echo Output on see 
Screen 


Insert LF After CR ese einen sn penne sinner 
Insert CR After 80 Characters pea ee tees eee ees 


Port 2 Default Your Device 


Communications Mode AsO i Comet 
8 Data Bits / 1 Stop Bit TE kl or le de ee 
300 Bits per Second See ee dO Se 
No Parity oP Fa ek ee Sate yA See ee 


Do Not Echo Output on Fe ee I eee ee Te 
screen 


Insert LF After CR 2 ee ee ee eee 
Do Not Insert CR Pe i, ee ae epee ae ae ee 
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i Figuring Out Your Own PIN 


Once you know the baud rate and other information about your 
device, you can either let the program derive your PIN or you 


can figure it out yourself using Figure 4-1. 


Figure 4-1. Determining a PIN. The number is made up of seven digits. Each digit corresponds to an option number. 


1 6 6 / 1 1 +2 4 


es 





1. <PRINTER MODE> 

ae Communications Mode 

1. 6 Data Bits / 1 Stop Bit 
2. 6 Data Bits / 2 Stop Bits 
cr 7 Data Bits 7 1 Step Bit 
4. 7 Data Bits / 2 Stop Bits 
5 8 Data Bits / 1 Stop Bit 
6. <8 DATA BITS / 2 STOP BITS> 
iz 110 Bits per Second 

eu 300 Bits per Second 

2 1200 Bits per Second 

4. 2400 Bits per Second 

aoe 4800 Bits per Second 

6. <9600 BITS PER SECOND> 

Le 19200 Bits per Second 


<NO PARITY> 
Even Parity 
Odd Parity 
Mark Parity 
Space Parity 


<DO NOT ECHO QUTPUT ON SCREEN> 
Echo Qutput on Screen 


Do Not Insert LF After CR 
<INSERT LF AFTER CR> 


Do Not Insert CR * 

Insert CR After 40 Characters 
Insert CR After 72 Characters 
<INSERT CR AFTER 80 CHARACTERS» 
Insert CR After 132 Characters 





moAWNMHH- NH NE NAWD = 


* If you select Communications Mode, digit 7 must be 1 (Do Not Insert CR). 
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= Setting the Serial Ports 


Once you know which settings you need or have found out your 
device’s PIN, you’re ready to use the Configure the Serial Ports 


utility. 
Important! Before you go any further, make a copy of 
Use Duplicate a Disk to make a System Utilities (if you haven't already), and use the backup 
copy of System Utilities. You'll tind copy when you configure your serial ports. The configuration 


a step by step tutorial in Chapter 1. : : 
eet ° program writes information on the disk (if you save your 


configuration), and you can’t alter the original System 
Utilities—it's write protected to prevent you from erasing or 
writing over valuable information by mistake. And since the 
utility writes on the disk, be sure your backup copy does not 
have a write-protect tab. 


1. Start up your copy of the utilities disk. 


By the Way: If you're already using your utilities disk, return 
to the Main Menu by pressing (ESC). 


2. Choose Advanced Operations from the Main Menu. 


3. Choose Configure the Serial Ports from the Advanced 
Operations Menu. You see a screen similar to Figure 4-2. 


34 | Chapter 4: Configure the Serial Ports 


Figure 4-2. Configure the Serial Ports Menu. The current device is listed with 
its PIN. 
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4. Choose the port you want to configure. You see your device 
list. It looks like Figure 4-3. 


Figure 4-3. Typical Device List 
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5. If your device is listed, choose it. 


If it's not listed, but you know the PIN, choose 8. You see a 
message asking you to type the PIN. Type the number and 
DreSS (RETURN ). You are asked if the PIN is correct. If the PIN 
is correct, answer Yes by pressing (RETURN). (If it’s not, 
answer No and press (RETURN), and you can try again.) 


If you don’t know the PIN, choose 9. Supply the information 
that is requested about your device. (If you’re unsure about 
any of the answers, accept the default.) When you supply all 
the information, you see a screen summarizing the 
information and displaying your PIN. If the information is 
correct, answer Yes by pressing (RETURN ). (If it’s not, answer 
No and press (RETURN), and you'll have another chance at all 
the settings.) 


6. Then you are asked if you want to save the configuration on 
your utilities disk. If you answer Yes by pressing (RETURN ), 
the information is saved on your disk as the default PIN for 
the port you are configuring. If you answer No, the port is 
configured, but the PIN isn’t saved on the disk for later use. 


That’s all there is to it. If you need to reconfigure the other port, 
do so the same way. When you've got both ports configured, 
start up the program you want to use by holding down and 


while you press (RESET). 


Try printing something or sending a message through your 
modem. If you have any problems, consult the troubleshooting 
section that follows. 
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Troubleshooting 7 


lf you had to guess at any of the settings, don't be surprised if 
your first crack at configuring the serial ports didn’t work. Here 
are some guidelines to help you decide which settings are 
wrong and how you should adjust them. 


Trial and Error: Don't be afraid to experiment with different 
settings until you find one that works—you won't break the 
computer or your peripheral device. But do it systematically. 
The most common cause of garbage is the wrong baud rate. 
Other problems have distinctive symptoms that will suggest 
what the problem is and what you can do about it. 


Troubleshooting Tips 


Here are some suggestions for getting your ports configured 
correctly. Try the suggested solutions one at a time until you 
find one that works. 


Symptom Solution 


Unintentional double or triple Turn the automatic line feed 

spacing. switch on the printer (or 
change the application 
program's line feed setting) to 
Off. 


Change the PIN so a line feed 
after a carriage return is not 
inserted. 


Both of the above. 


Lines are printing on top of Turn the automatic line feed 
each other. switch on the printer to on. 


Change the PIN so a line feed 
after a carriage return is 
inserted. 
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Symptom 


Characters are lost during 
data transfer. 


General garbage. 


Unintentional carriage returns. 


Text runs off the page. 


Two of every character 
appears on the screen while 
sending messages through a 
modem. 


Information sent through a 
modem doesn't appear on the 
screen. 


Output to a printer is the same 
width as the screen when you 
wanted it wider. 


Troubleshooting 


Solution 


Change to a lower baud rate, 
if possible, on both the 
sending and receiving ends. 


Check the baud rate you are 
using against the device's 
manual—if it’s wrong, change 
the PIN or change the switch 
on your printer or modem. 


Check the data format (data 
bits/stop bits/parity) against 
the device’s manual—if it’s 
wrong, change the PIN or 
change the switch on your 
printer or modem. 


Change the line width so that 
a Carriage return is not 
generated. This lets the 
application program insert its 
own carriage returns. 


Set the line width to a lower 
number. 


Change the PIN so output is 
not echoed on the screen. 


Change the PIN so output is 
echoed on the screen. 


Change the PIN so output is 
not echoed on the screen. 
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Troubleshooting Techniques 


some symptoms give you unmistakable clues to what the 
problem is. For example, if you're getting too many line feeds 
after a carriage return, you know that you have to adjust the 
line feed on your printer—through your application program or 
by changing the PIN. Problems with line width and echo are 
equally easy to detect and solve. 


Problems with baud rate and with data format (data bits/stop 
bits/parity) are a little tougher to diagnose. They all produce a 
string of unrelated characters (garbage in the computer 
vernacular). 


If you get garbage on your printer or display, start by checking 
the baud rate in the manual. (If you can’t find the baud rate for 
your printer or plotter, try 9600, then 1200. If you can’t find the 
baud rate for your modem, try 300, then 1200.) 


If baud rate isn’t the problem, experiment with different data 
formats, starting at the top of Table 4-1 (for printers) and 
Table 4-2 (for modems) and working your way down. Use the 
boxes on the right to check off the combinations you’ve tried. 


One Thing at a Time: Whatever you do, don’t change all 
the settings at once. Alter one setting at a time, then make a 
test before going on to the next variation. And keep track of 
what you’ve tried so you don’t keep going over the same 
ground. 


Table 4-1. Common Printer Settings 


Data Stop 
Bits Bits Parity 


off 

off 
odd 
even 


odd 


Li tlt) Oo a 


even 
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Table 4-2. Common Modem Settings 


Data Stop 


Bits Bits Parity 
8 1 off [| 
7 2 off [] 
7 1 off [] 
8 1 odd [] 
8 1 even [| 
Fj 2 odd. CJ 
7 1 even [] 


Important! Because of timing peculiarities in the baud rate ’ 
-generator of the Apple llc, some modems may requirea 
different data format than the one listed in the modem or | _ 
information service manual. er with different oe 
until you find the one that works. _  - | 


oS Editing the Device List 


lf you have several devices that share the serial ports, you 
should add all of your devices and their PINs to the device list 
so that the ports are easy to reconfigure. The device list 
includes several popular Apple devices and has place holders 
for other devices. If you run out of space, you can replace the 
Apple devices that you don’t plan to own. Here's how: 


1. Select option 3, Edit the Device List, from the Configure the 
Serial Ports Menu. 


2. Highlight the line you want to replace and press (RETURN). 
You see a new screen and this message: 


Enter New Device Name: 


3. Type a name for your device and press (RETURN ). 


4. You are asked if you know the device's PIN. 
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5. If you Know the PIN, answer Yes by pressing (RETURN). Then 
type the number. You are asked if the PIN is correct. If you 
answer Yes, you see a new device list with your device's 
name and PIN. 


If you don’t know the PIN, answer No by pressing (RETURN ), 
then choose the options that describe your device. (If you 
don't know which option to pick, accept the default by 
pressing (RETURN ).) When you finish supplying the 
information, you see a screen, like Figure 4-4, that 
summarizes the information you supplied and displays the 
PIN. If the information is correct, answer Yes by pressing 


(RETURN ). 


Figure 4-4. Checking the Parts of the PIN 
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6. Then you are asked if you want to save the configuration on 
your utilities disk. If you answer Yes by pressing (RETURN ), 
the revised device list is copied onto your copy of the utilities 
disk so that you can use the information later. 


Once all your devices are on the list, it's easy to swap port 
configurations. Here's how: 


1. Start up your utilities disk. 

2. Choose option 8, Advanced Operations, from the Main Menu. 
3. Choose option 5, Configure the Serial Ports. 

4. Choose the port you want to configure. 

5. Choose the device you want to use. 


6. Start up your application by putting the program disk in the 
built-in disk drive and holding down while you press 


(CONTROL )-( RESET ). 
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Xi pusdde 


Applesoft BASIC is built into the computer. (You can get to it by 
starting up the Apple Ilc without a disk in the built-in disk drive. 
You'll see a message to check the disk drive. Just ignore the 


message and hold down while you press (RESET ).) 


But to save your programs, you must load the ProDOS 
operating system into the computer before you start 
programming. 


There are three ways to do this. 


e Start up Getting Down to BASIC, of the interactive owner's 
guide, and select the Quit option. 


e Start up System Utilities and select Exit System Utilities 
from the Main Menu. 


e Create a disk that automatically loads ProDOS and puts you 
into BASIC (see the next section). 


crea ting a ProDOS Siartup Disk | 


You can create your own startup disk by following these steps. 
1. Format a disk (for ProDOS). 


2. Copy the files PRODOS and BASIC.SYSTEM from System 
Utilities to your formatted disk. 


Starting up this disk loads ProDOS and puts you into BASIC. 


If you want one of your programs to run automatically, put it on 
a ProDOS startup disk and name your program STARTUP. 
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backup: A copy of a disk. (It's a good idea to make backup 
copies of all your important disks and use the backup.) 


baud: Bits per second. A designation for how fast peripheral 
devices can receive and/or send data. 


Carriage return: The event that occurs when the print head 
reaches the end of a line and returns to the start of the line. 


configuration: In the case of System Utilities, the way your 
serial ports are set up. 


copy protect: Jo render a disk impossible to duplicate by 
ethical means. 


CR: See carriage return. 


data bits: The computer sends and receives information as a 
String of bits. These are called data bits. 


default: A recommended response to a question in a 
program. The response will be used by default unless you 
supply an alternative. 


destination: The disk you're copying to. Compare source. 


DOS 3.2: An early Apple Il operating system. DOS stands for 
Disk Operating System, 3.2 is the version number. 


DOS 3.3: One of three operating systems used by the 
Apple llc. DOS stands for Disk Operating System; 3.3 is the 
version number. 


file: A collection of information that you store on a disk (like a 
program or a memo). 
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format: To divide a disk into sections where information can be 
stored. Blank disks must be formatted before you can save 
information on them for the first time. 


highlight: In the case of System Utilities, a pair of angled 
brackets that distinguishes your selection from others in a list. 


LF: See line feed. 
line feed: Act of advancing to the next line. 


line width: Number of characters that fit on a line on the 
screen or on a page. 


mode: Manner of operating—in the case of System Utilities, 
either printer or communications (modem) mode. 


modem: Short for modulator/demodulator. A device that links 
your computer to other computers via phone lines. 


operating system: A program that, among other things, 
controls the way information is loaded into memory, the way the 
computer works with the information, the way information is 
stored on a disk, and the way the computer talks to printers 
and other peripheral devices. ProDOS, DOS 3.3, and Pascal are 
three operating systems available for the Apple llc. 


parity: A bit used to check for errors during data 
transmission. 


Pascal: Both an operating system and a programming 
language. 


pathname: The full name of a file. A pathname begins with 
the disk (volume) name, then lists any subdirectory names, and 
ends with the filename. Each part of the name is separated by a 
slash (/). 


PIN: See product identification number. 
prefix: The first part of a pathname stored in memory. 
ProDOS: The primary operating system for the Apple llc. 


product identification number: A seven-digit number that 
describes a device's characteristics, such as baud rate, used to 
configure the serial ports on the Apple Ilc. 


prompt: A message on the screen. 


Glossary 


serial: Things occurring one after another. A serial device 
sends and receives information one bit at a time. See serial 
port. 


serial port: Outlet for a peripheral device on the back of the 
Apple llc. 


source: [he original—the disk you’re copying from. Compare 
destination. 


stop bits: One or two bits that indicate the end of a 
character. 


subdirectory: A directory within a directory. 
utilities: A set of file and disk management programs. 
volume: Another word for disk. 


write protect: To prevent accidental changes to the contents 
of a disk by covering the write-enable notch with a write-protect 
tab. 
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